OLA 文档中心

主题

2026-06-10

加载图片 - LoadImageFromRGBData ​

函数简介 ​

从RGB数据加载图片到内存，适用于采集卡或其他RGB数据源。

接口名称 ​

LoadImageFromRGBData

DLL调用 ​

long LoadImageFromRGBData(long ola, int width, int height, long rgbdata, int stride);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
width整数型图片宽度，单位像素
height整数型图片高度，单位像素
rgbdata长整数型RGB图片数据的地址
stride整数型RGB图片数据的行跨度（每行字节数），通常为 width * 3

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long handle = ola.LoadImageFromRGBData(800, 600, 0, 0);
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long handle = ola.LoadImageFromRGBData(800, 600, 0, 0);
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
handle = ola.LoadImageFromRGBData(800, 600, 0, 0)
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long handle = ola.LoadImageFromRGBData(800, 600, 0, 0);
cpp
var ola = com("OlaPlug.OlaSoft")
var handle = ola.LoadImageFromRGBData(800, 600, 0, 0)
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
handle = ola.LoadImageFromRGBData(800, 600, 0, 0)
text
.局部变量 ola, OLAPlug
ola.创建 ()
handle ＝ ola.LoadImageFromRGBData(800, 600, 0, 0)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var handle = ola.LoadImageFromRGBData(800, 600, 0, 0);
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 handle = ola.LoadImageFromRGBData(800, 600, 0, 0)
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long handle = ola.LoadImageFromRGBData(800, 600, 0, 0);

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
LoadImageFromRGBData(instance, 800, 600, 0, 0);
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long LoadImageFromRGBData(long ola, int width, int height, long rgbdata, int stride);

long instance = CreateCOLAPlugInterFace();
LoadImageFromRGBData(instance, 800, 600, 0, 0);
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ola.LoadImageFromRGBData(instance, 800, 600, 0, 0)

返回值 ​

长整数型：成功返回OLAImage对象的地址，失败返回0。

注意事项 ​

  • RGB数据格式必须为24位真彩色（每像素3字节）。
  • 返回的图片需调用 FreeImagePtr 释放内存。
  • 确保RGB数据在图片使用期间保持有效。